
#### Table of Contents

1. packages.config
2. Startup class
3. API Controller class: TestController
4. Interface
5. class implement interface

This blog shows how to setup Autofac at ASP.NET Web API 2 with Owin.

### packages.config

Following is the package.config, you can use this nuget command to install all
the these to your project.Update-Package -ProjectName MyProject -reinstall

```
<?xml version="1.0" encoding="utf-8"?>















```

### Startup class

```
using Autofac;
using Autofac.Integration.WebApi;
using Microsoft.Owin;
using Owin;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Reflection;
using System.Web;
using System.Web.Compilation;
using System.Web.Http;
using WebApplication2.Controllers;

[assembly: OwinStartup(typeof(WebApplication2.Startup))]
namespace WebApplication2
{
    public class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            HttpConfiguration config = new HttpConfiguration();
            // register api routing.
            WebApiConfig.Register(config);
            app.UseWebApi(config);

            var builder = new ContainerBuilder();

            var assemblies = BuildManager.GetReferencedAssemblies().Cast().ToArray();

            builder.RegisterAssemblyModules(assemblies);
            builder.RegisterApiControllers(assemblies);

            var container = builder.Build();
            config.DependencyResolver = new AutofacWebApiDependencyResolver(container);

            app.UseAutofacMiddleware(container);
            app.UseAutofacWebApi(config);
            app.UseWebApi(config);
        }
    }
}
```

### API Controller class: TestController

```
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;

namespace WebApplication2.Controllers
{
    public class TestController : ApiController
    {
        Interface1 _i;
        public TestController(Interface1 i)
        {
            _i = i;
        }

        public IHttpActionResult Get()
        {

            return Ok(new List() { "Hi", "I", "'m", "Just", "testing" });
        }
    }
}
```

### Interface

```
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace WebApplication2
{
    public interface Interface1
    {
        string Do();
    }
}
```

### class implement interface

```
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;

namespace WebApplication2
{
    public class Class1 : Interface1
    {
        public string Do()
        {
            return Guid.NewGuid().ToString();
        }
    }
}
### Autofac Service Module


using Autofac;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;

namespace WebApplication2
{
    public class ServiceModule : Module
    {
        protected override void Load(ContainerBuilder builder)
        {
            builder.RegisterType().As().InstancePerDependency();
        }
    }
}
```


How to setup ASP.NET Web API 2 with Autofac and Owin

ASP.NET Web API 2 with Autofac Owin


#### Table of Contents

1. Issue: Use C# SyndicationFeed to read rss sometime throw exception
2. Why?
3. Sample Data
4. Sample Code
5. Conclusion

## Issue: Use C# SyndicationFeed to read rss sometime throw exception

### Why?

Reading rss feed should be simple, W3C define the format for
RSS, everyone also should be just following the same format and create library
for it. You can use the
W3C RSS validator tool for check your own RSS feed or not. Now, following is about how to read rss
page by C#. C# provide the `SyndicationFeed` for communicte with
RSS. However I've seen sometime C# code will throw exception depend on what
value of RSS Feed Item's `Publish Date`, following is a example
will throw exception when reading the RSS.

Le'ts say you have following type of rss feed need to read. You could get the
RSS from this url
http://www.asp.net/rss/content

### Sample Data

```

Your First ASP.NET 5 Web App Using Visual Studio

http://docs.asp.net/en/latest/tutorials/your-first-aspnet-application.html


In this tutorial, you&rsquo;ll create a simple web app using ASP.NET 5. The app stores data in a SQL database using Entity Framework (EF) and uses ASP.NET MVC to support the basic CRUD operations (create...

tutorials/your-first-aspnet-application
Wed, 16 Mar 2016 00:00:00

```

### Sample Code

Now, this is the C# code will read the above RSS and will throw exception
depend on the Publish Date value.

```
string url = "http://www.asp.net/rss/content";
 using (HttpClient client = new HttpClient())
            {
                var task = client.GetAsync(url);
                string result = task.Result.Content.ReadAsStringAsync().Result;

                using (MemoryStream stream = new MemoryStream(Encoding.UTF8.GetBytes(result)))
                {
                    using (XmlReader reader = XmlReader.Create(stream))
                    {
// Throw exception
                        SyndicationFeed feed = SyndicationFeed.Load(reader);

                    }
                }
}
```

This is my another version to safty check the RSS, which not use the C#
`SyndicationFeed` but use C# `XDocument` to read it.

#### Main class to read rss

```
string url = "http://www.asp.net/rss/content";
            using (HttpClient client = new HttpClient())
            {
                var task = client.GetAsync(url);
                string result = task.Result.Content.ReadAsStringAsync().Result;

                using (StringReader sr = new StringReader(result))
                {
                    XDocument xd = XDocument.Load(sr);
                    foreach (var item in xd.Descendants("item"))
                    {
                        string link = XElementToString(item.Element("link"));
                        string title = XElementToString(item.Element("title"));
                        string desc = XElementToString(item.Element("description"));
                        string guid = XElementToString(item.Element("guid"));
                        DateTime pubDate = XElementToDate(item.Element("pubDate"));
// TODO: you can convert all other rss feed
                    }
                }
            }
```

#### Just one simple helper class to safty check the XElement

```
public static string XElementToString(XElement xElement)
        {
            if (xElement == null)
            {
                return string.Empty;
            }

            return xElement.Value;
        }
```

### Conclusion

The code is very simple, I might create library as Nuget Library next time.
The library read all the defined RSS feed in C# or maybe in javascript too. My
question is... Does RSS will be dead?


C# RSS Reader Publish Date Issue


1. [ASP.NET Solution Template

A solution layout for a typical ASP.NET web application, pre-configured
with Git, Gulp.js, NuGet and StyleCop development tools. It is well suited
for developing a single-page application (SPA).

ASPNET MVC ANGULAR Project Template

Installation for ASPNET MVC Angular project Visual studio extension

CodeMaid

CodeMaid is an open source Visual Studio extension to cleanup, dig through
and simplify our C#, C++, F#, VB, PHP, JSON, XAML, XML, ASP, HTML, CSS,
LESS, SCSS, JavaScript and TypeScript coding.

webessentials](https://visualstudiogallery.msdn.microsoft.com/359f4304-57d7-4178-9cab-165e2090dce2)

2. If you ever write CSS, HTML, JavaScript, TypeScript, CoffeeScript or LESS,
then you will find many useful features that make your life as a developer
easier.

3. [Productivity Power Tools

A set of extensions to Visual Studio 2013 Professional (and above) which
improves developer productivity.

Indent Guides

Adds vertical lines at each indent level.

Task Runner Explorer

Provides custom task runner support to Visual Studio.

GhostDoc

GhostDoc is a Visual Studio extension that automatically generates XML
documentation comments for methods and properties based on their type,
parameters, name, and other contextual information.

Ionic Tabs Template](https://visualstudiogallery.msdn.microsoft.com/dbcb8670-889e-4a54-a226-a48a15e4cace)

4. Build a cross-platform hybrid mobile app for iOS, Android, and Windows
Phone with the Ionic Framework and Apache Cordova. This project comes with
a simple tab-based layout.

Paid extensions for visual studio, ReSharper, OzCode, NCrunch, .NET Reflector


Few Useful Visual Studio Extensions for .NET


#### Table of Contents

1. @ViewBag.Data1
2. @ViewBag.Test2

```
// index.cshtml

@{
    ViewBag.Title = "Index";
}
```

## @ViewBag.Data1

```
// test.cshtml
@{
    ViewBag.Title = "Test2";
}
```

## @ViewBag.Test2

```
// define the class for page data
 public class AllPage
    {
        public AllPage()
        {
            Pages = new List();
        }

        public List Pages { get; set; }
    }

    public class Page
    {
        public Page()
        {
            PageData = new List();
        }

        public string RequestUrl { get; set; }
        public string RazorName { get; set; }
        public List PageData { get; set; }
    }

    public class PageData
    {
        public string TmplName { get; set; }
        public string TmplValue { get; set; }
    }
```

```
// get page data
 private AllPage _page;
        public HomeController()
        {
            AllPage pages = new AllPage();
            pages.Pages.Add(new Page
            {
                 RequestUrl = "/",
                 RazorName = "Index",
                 PageData = new List { new PageData
                 {
                       TmplName = "Data1",
                        TmplValue = "Index.Data1.Value1"
                 }}
            });

            pages.Pages.Add(new Page
            {
                RequestUrl = "/Test2",
                RazorName = "Test2",
                PageData = new List { new PageData
                 {
                       TmplName = "Test2",
                       TmplValue = "Test2.Data1.Value1"
                 }}
            });
            _page = pages;
        }
```

```
// handler all page data in one action
 public ActionResult Index()
        {
            var requestUrl = Request.Url.AbsolutePath;
            var page =_page.Pages.Where(x => x.RequestUrl.Equals(requestUrl, StringComparison.CurrentCultureIgnoreCase)).FirstOrDefault();
            if (page == null)
            {
                // go to 404 page
                return View();
            }

            page.PageData.ForEach(_ =>
            {
                ViewData.Add(_.TmplName, _.TmplValue);
            });

            return View(page.RazorName);
        }
```


Sample Code - Use ASP.NET MVC With Razor


#### Table of Contents

1. Encrypt connectionString
2. Decrypt connectionString
3. Complicated!!

### Encrypt connectionString

Following task is only for initial check-in for the encrypted
connectionString, once you have checked-in the Encrypted connectionString you
do not need to do following.

What following command is doing is, use aspnet_regiis.exe to encrypt
connectionStrings from Web.config and use provider as customProvider

```
C:\Windows\Microsoft.NET\Framework\v4.0.30319>aspnet_regiis.exe -pef connectionStrings C:Projects2013\LDWebsite\Source\Development\DEV3\Website -prov "customProvider"
C:\Windows\Microsoft.NET\Framework\v4.0.30319>aspnet_regiis.exe -pef connectionStrings {location where contains Web.config} -prov "customProvider"

    ```

### Decrypt connectionString

copy the decrypt connectString to the Web.config's connectionString section
and run following task. Then if will decrypt the connectionString. Following
is check c driver's website folder's web.config.

```
`C:\Windows\Microsoft.NET\Framework\v4.0.30319>aspnet_regiis.exe -pdf connectionStrings C:\Website -prov "customProvider"
Share encrypt connectionString to other enviroment or web Farm
first need to export containerKey as xml by running following command
C:\Windows\Microsoft.NET\Framework\v4.0.30319>aspnet_regiis.exe -px "YourRSAKeyName" "c:\xmlKey.xml"
At other environment just try to run following command
set "keyPath=%cd%\xmlKey.xml"
cd C:\Windows\Microsoft.NET\Framework\v4.0.30319
aspnet_regiis -pi "myKey" "%keyPath%"
aspnet_regiis -pa "myKey" "NT AUTHORITY\NETWORK"
pause`

```

```
:: this task is for add RSA key so each machine so that encrpt connectionString could use at any enviroment, local, dev, qa or web farm.
:: webconfig's connectionString is already encrypted, if not running this task application would not be able to use encrypted connectionString.
:: following is pre requirement for running this task
:: 1. target machine is .NET 4.0
:: 2. under C:\Windows\Microsoft.NET\Framework\v4.0.30319, aspnet_regiis is exist
:: 3. website's application pool identity is running under NetworkService
:: If above 1-3 is valid, you're ready to run this command line.
:: First task is register RSA Key Container in side to the machine
:: Second task is grant networkService permission to the RSA Key Container
:: After run this two task if you see 'Succeeded!', then you're good!
:: about how to use aspnet_regiis.exe to encrypt webconfig see


```

### Complicated!!

I know, we could just use same service account for application pool and use
that account to connet to database, so we could remove the user and password
from connection string.


How to Encrypt/Decrypt Web.config connectionString

Encrypt Decrypt Web.config ConnectionString by Use aspnet_regiis


Simple example of how to achieve cross domain access at asp.net, following
example is the simple and lazy way which just make it working by modify
web.config.

let's assume you have following  two site, client-site.com is trying to
access server-site.com's ajax api, /api/getMyData

  - client-site.com

  - server-site.com

    - contains /api/getMyData

So, what's you have to do at server-site.com site is following, you're let
your server to return Access-Control-Allow-Origin header to the http
response.

```







```

client-site.com site you can just call as following, assume your api is
server-site.com/api/getMyData

```

$.ajax({ url: "http://server-site.com/api/getMyData" }).then(function () {
            console.info("done with call server-site.com's api");
        });


```

for more detail information about how to enable cross for specific http
method, specific site, or other usefull library. I'll add reference at here or
code example.

Enabling Cross-Origin Requests in ASP.NET Web API 2


Simple example of how to achieve cross domain access at asp.net.

Cross-Origin Resource Sharing Example with ASP.NET

#### Table of Contents

1. Example.pubxml
2. What's next?

Few tips for deploy aspnet web application

For a enterprise ASP.NET web application scenarios please reference following
documents.

Deploying Web Applications in Enterprise Scenarios

Understanding the Project File

Deployment made simple using Powershell

During the application build or deploy if you have anything need to be include
but not checked-in to the project, you can try following command.

Following is example command that during the project build it will copy files
or folder to sepecific location depend on you are on local or deploy. If you
use powershell to write your own deployment scripts following project, csproj
code will copy the files or folder, which you don't need to write that to
powershell.

```




    

    


```

### Example.pubxml

Following is almost same thing like previous code is doing, however it will
use project pubxml.

```
<?xml version="1.0" encoding="utf-8"?>
FileSystem
    YourConfigurationName
    Any CPU

    True
    False
    C:\YourLocalFolder
    False



      <_CustomFiles Include="$(MSBuildProjectDirectory)\TargetFolder\**\*" />

        TargetFolder\%(RecursiveDir)%(Filename)%(Extension)




    copyAdditionalFilesOrFolderForDeploy;;


```

Powershell Gallery

### What's next?

For deployment, should use visual studio 2015's
DevOps deployment tools.

Tips About How to Deploy ASP.NET Web Application


#
AddMVCModuleDynamic

##
A very simple version of how to make ASP.NET MVC modular

##
Tools

Visual Studio 2013, C#, MVC

This mvc web application template demostrate how you can dynamic add mvc
projects to your main web mvc application.

With this example, you can have distributed team that one team work one MVC
project 1 + all the backend domain and database access. one team work another
MVC project 2 with the different backend projects.

When you build and deploy is very simple, you just build solution then all the
mvc project will go to the main web mvc project. and when deploy the main web
project, the application will grap the files and deploy too.

##
Key Points

  - Main MVC project has no reference to other MVC projects

  - *.pubxml is the key file need to edit when publish

  - Each module mvc project need to add following command after build

xcopy /E /Y /D "$(ProjectDir)Views" "$(SolutionDir)MainWeb\Views"

      - xcopy /E /Y /D "$(ProjectDir)Scripts" "$(SolutionDir)MainWeb\Scripts"

      - xcopy /E /Y /D "$(ProjectDir)Content" "$(SolutionDir)MainWeb\Content"

##
Things need to watch out

  - Need to becareful use the dll version between projects.

  - Have not tested during build will bring all module mvc project's referenced
dll

  - Not support for DI, Ioc module yet.

Github


Simple Code to create ASP.NET MVC module.

Sample Code for Creating ASP.NET MVC


Few list to learn sitecore. Athough, I don't like Sitecore, but just in case
if I have to do it, following are list of resource for reference.

[Sitecore Official Site](http://www.sitecore.net/)

[Sitecore Blog - 1

Sitecore Blog - 2

Sitecore Blog - 3

Sitecore Blog - 4

Sitecore Blog - 5](http://sitecoreexperiences.blogspot.com/)

[Sitecore Blog - 6](http://webcmd.wordpress.com/)

Sitecore Blog - 7

NewGuid.Net

all Sitecore related cotent

wikipedia Sitecore

Learn Sitecore - 1 - firebreaksice

Learn Sitecore - 2

Learn Sitecore - 3 - great documents


Few list to learn sitecore. Athough, I don't like Sitecore, but just in case if I have to do it, following are list of resourcefor reference.

List of Useful Links to Learn Sitecore

#### Table of Contents

1. What's Swagger?
2. Use Azure API App template with Swagger
3. Can I Use a customized stylesheet for Swagger?
4. 1. CSS file
5. 2. SwaggerConfig
6. 3. Global.ascx
7. Can I add my own Javascript file to Swagger API documents?
8. 2. SwaggerConfig for Html
9. 3. That's it, let's check the browser.
10. Add .NET XML comment for swagger's API description
11. Conclusion

This walkthrough turtorial is about how to setup Swagger with ASP.NET MVC API
by using Visual Studio 2015, also provide steps of how to customize the
swagger UI.

## What's Swagger?

Swagger could provide more rich documents for your API, but that's not it, it
provides how to design tests and documentation about your API. Although, this
blog just focuses on how to set up Swagger UI on Visual Studio 2015's ASP.NET
API project. ASP.NET MVC also has a Web API Helper page but unlike Swagger,
which is more powerful with client generation, discoverable, and more
developer support.

This blog will show how to use Swagger to ASP.NET MVC API project and provide
a list of how to.

> With a Swagger-enabled API, you get interactive documentation, client SDK
> generation and discoverability.

```
Install-Package Swashbuckle
```

Following are few information relative with Swagger.

  - [swagger.io](http://swagger.io/)

  - Swashbuckle

  - swagger-codegen

  - swagger-ui

  - OpenAPI Specification

## Use Azure API App template with Swagger

You can use Swagger with Visual Studio 2015, ASP.NET 4.5.2 Templates. Once you
use Visual Studio and create a web application by template Azure API App, at
your solution you should see the following Swagger at the package file.

![](http://res.cloudinary.com/dmwrakaup/image/upload/v1458931625/vrtczaiykyxoxtecgloc.png)

You will find the NuGet library `Swashbuckle`, that .NET version of
Swagger, if you want to use the latest NuGet version. You can use NuGet to
uninstall the package and install the latest NuGet package again.

![](https://d1p0mp3f1fx0hz.cloudfront.net/_dp4q0c174.png)

###
`SwaggerConfig` and `EnableSwaggerUi` and basic
configuration

After installing Swashbuckle, you will see a SwaggerConfig under your
App_Start folder. This `SwaggerConfig` is the start point to enable
Swagger. At the following, if you have already contained, then your setup is
done. We should see the API document written by Swagger.

```
[assembly: PreApplicationStartMethod(typeof(SwaggerConfig), "Register")]

namespace WebApplication1
{
    public class SwaggerConfig
    {
        public static void Register()
        {
            var thisAssembly = typeof(SwaggerConfig).Assembly;

            GlobalConfiguration.Configuration

                .EnableSwagger(c =>
                    // {...
                    // this will enable swagger UI
                .EnableSwaggerUi(c =>
```

###
Build the solution and check the URL
`{yoururl}/swagger or {yoururl/swagger/ui/index`

Boom!!!, you should be able to see the following swagger UI document page. I
have two Web APIs, `TestController` and
`ValuesController.`As you can see, it contains a search feature
and you can try it out!!?

![](http://res.cloudinary.com/dmwrakaup/image/upload/v1458932570/vbbqw3dh7xbalqxmxlyd.png)

![](https://d1p0mp3f1fx0hz.cloudfront.net/_3cxww0sfn.png)

However, I also got the following question when I first see these pages
generated by Swagger.

  - Can I change this API document's UI, including logo, stylesheet?

  - Can I add javascript to this?

  - Can I change the URL instead of /swagger?

  - Can I add my own page to this auto-generated page?

  - Can I make certain Web API does not show?

  - Can I turn the swagger's API documents off at production, but only in
development?

I might not cover all these questions I have in my mind but will give them a
try and list them here.

### Can I Use a customized stylesheet for Swagger?

Let's assume I want to change the following style, which changes the header
background color to `#704C8F`.

### 1. CSS file

```
.swagger-section #header {
    background-color: #704C8F;
    padding: 14px;
}
```

### 2. SwaggerConfig

```
.EnableSwaggerUi(c =>                   {
c.InjectStylesheet(Assembly.GetAssembly(typeof(WebApiApplication)), "WebApplication2.styles.swagger_test.css");
```

### 3. Global.ascx

#### How the WebApiApplication looks like

The SwaggerConfig's InjectStylesSheet's first parameter need to pass the
current application's assembly, the second parameter is a little tricky. The
filename `WebApplication2.styles.swagger_test.css`is
`Project Folder name`.`{folder name}` and the file name.

```
namespace WebApplication2
{
    public class WebApiApplication : System.Web.HttpApplication
    {
        protected void Application_Start()
        {
            AreaRegistration.RegisterAllAreas();
            GlobalConfiguration.Configure(WebApiConfig.Register);
            RouteConfig.RegisterRoutes(RouteTable.Routes);
        }
    }
}
```

#### 4. styles file location

Also, this is very important, you have made the file BuildAction an Embedded
Resource.

```

```

#### 4. After 1 - 4 steps, how the page looks like

![](http://res.cloudinary.com/dmwrakaup/image/upload/v1458968917/vetiqfmu4mizsfyolm2h.png)

### Can I add my own Javascript file to Swagger API documents?

You are able to do it as follows, assume you have a javascript file like this.

1. Javascript

```
(function () {
    function init() {

        console.info("init for my swagger function");

        $("#explore").click(function () {
            alert("you clicked explore");
        });
    }

    init();
})();
```

#### 2. Javascript file location and Build Action Property

```

```

#### 3. SwaggerConfig class

set the javascript path as string type like following.

```
var myAssembly = Assembly.GetAssembly(typeof(WebApiApplication));
   c.InjectJavaScript(myAssembly, "WebApplication2.js.swagger_test.js");
```

#### 4. Done, check the page

When the page load, you can see the javascript console message, now you can
add javascript to the page, my next question is can I change the default Html?

![](http://res.cloudinary.com/dmwrakaup/image/upload/v1458969860/h3novy9llbwau4kearez.png)

###
Now, we know we can change javascript, CSS, can we change the entire HTML?

Yes, and the main feature will still work if you use the swagger's existing
javascript. Following is how we can do it.

#### 1. Html Files

This time I want to add two HTML, after creating these HTML you also have to
change Build Action as Embedded Resource again.

![](http://res.cloudinary.com/dmwrakaup/image/upload/v1458971711/evgs4ci6wclqwpqpirxg.png)

swagger_test.html

```
Bomm!!!!
```

OtherVersion.html

```
<!DOCTYPE html>



    Swagger UI My Own Version






















    
    
    
    


    $(function () {
      var url = window.location.search.match(/url=([^&]+)/);
      if (url && url.length > 1) {
        url = decodeURIComponent(url[1]);
      } else {
        url = "http://petstore.swagger.io/v2/swagger.json";
      }

      // Get Swashbuckle config into JavaScript
      function arrayFrom(configString) {
        return (configString !== "") ? configString.split('|') : [];
      }

      function stringOrNullFrom(configString) {
        return (configString !== "null") ? configString : null;
      }

      window.swashbuckleConfig = {
        rootUrl: 'http://localhost:65343',
        discoveryPaths: arrayFrom('swagger/docs/v1'),
        booleanValues: arrayFrom('true|false'),
        validatorUrl: stringOrNullFrom('http://localhost:65343/validator'),
        customScripts: arrayFrom('ext/WebApplication2-js-swagger_test-js'),
        docExpansion: 'none',
        oAuth2Enabled: ('false' == 'true'),
        oAuth2ClientId: '',
        oAuth2ClientSecret: '',
        oAuth2Realm: '',
        oAuth2AppName: '',
        oAuth2ScopeSeperator: ' ',
        oAuth2AdditionalQueryStringParams: JSON.parse('{}')
      };

      // Pre load translate...
      if(window.SwaggerTranslator) {
        window.SwaggerTranslator.translate();
      }
      window.swaggerUi = new SwaggerUi({
        url: swashbuckleConfig.rootUrl + "/" + swashbuckleConfig.discoveryPaths[0],
        dom_id: "swagger-ui-container",
        booleanValues: swashbuckleConfig.booleanValues,
        onComplete: function(swaggerApi, swaggerUi){
          if (typeof initOAuth == "function" && swashbuckleConfig.oAuth2Enabled) {
            initOAuth({
              clientId: swashbuckleConfig.oAuth2ClientId,
              clientSecret: swashbuckleConfig.oAuth2ClientSecret,
              realm: swashbuckleConfig.oAuth2Realm,
              appName: swashbuckleConfig.oAuth2AppName,
              scopeSeparator: swashbuckleConfig.oAuth2ScopeSeperator,
              additionalQueryStringParams: swashbuckleConfig.oAuth2AdditionalQueryStringParams
            });
          }

          if(window.SwaggerTranslator) {
            window.SwaggerTranslator.translate();
          }

          $('pre code').each(function(i, e) {
            hljs.highlightBlock(e)
          });

          addApiKeyAuthorization();

          window.swaggerApi = swaggerApi;
          _.each(swashbuckleConfig.customScripts, function (script) {
            $.getScript(script);
          });
        },
        onFailure: function(data) {
          log("Unable to Load SwaggerUI");
        },
        docExpansion: swashbuckleConfig.docExpansion,
        jsonEditor: false,
        apisSorter: null, // default to server
        defaultModelRendering: 'schema',
        showRequestHeaders: false
      });

      if (window.swashbuckleConfig.validatorUrl !== '')
        window.swaggerUi.options.validatorUrl = window.swashbuckleConfig.validatorUrl;

      function addApiKeyAuthorization(){
        var key = encodeURIComponent($('#input_apiKey')[0].value);
        if (key && key.trim() != "") {
          var apiKeyAuth = new SwaggerClient.ApiKeyAuthorization("api_key", key, "query");
            window.swaggerUi.api.clientAuthorizations.add("api_key", apiKeyAuth);
            log("added key " + key);
        }
      }

      $('#input_apiKey').change(addApiKeyAuthorization);

      // if you have an apiKey you would like to pre-populate on the page for demonstration purposes...
      /*
        var apiKey = "myApiKeyXXXX123456789";
        $('#input_apiKey').val(apiKey);
      */

      window.swaggerUi.load();

      function log() {
        if ('console' in window) {
          console.log.apply(console, arguments);
        }
      }
  });



    Damn, I love this! Swagger!





```

### 2. SwaggerConfig for Html

```
c.CustomAsset("swagger_test", myAssembly, "WebApplication2.html.swagger_test.html");
                        c.CustomAsset("OtherVersion", myAssembly, "WebApplication2.html.OtherVersion.html");
```

### 3. That's it, let's check the browser.

Now, you're going to ask a question, what's the URL. I didn't figure it out at
the first, but look like Swagger is using the file name as the URL. Since
their default page is /swagger/ui/index, so my new files' URL will be
`/swagger/ui/OtherVersion` and
`/swagger/ui/swagger_test`

Following is one of my new pages, OtherVersion. Isn't this so sweet? As a
developer when you use other UI Framework if you can replace CSS, Javascript
and HTML but keep their original logic. That's just fantastic.

![](http://res.cloudinary.com/dmwrakaup/image/upload/v1458972150/uiblm9hoxxitxz1fgxls.png)

### Add .NET XML comment for swagger's API description

ASP.NET WebAPI's default API helper document also looks for DLL's XML comment
for description. We can do that in swagger too.

#### 1. Project property

The first thing you need to do is go to the project that contains the API
controller to check the XML documentation file, so when building the solution
visual studio will update the XML with comments you add to the class. Also,
swagger later will read the XML's comment as a description of the API too.

![](http://res.cloudinary.com/dmwrakaup/image/upload/v1459030325/o170ozq0mak76k8hfoqi.png)

#### 2. SwaggerConfig setting

The next important thing is, swagger has not registered the API XML, you can
add it as follows.

```
c.IncludeXmlComments(string.Format(@"{0}\bin\APIDemo.XML", System.AppDomain.CurrentDomain.BaseDirectory));
```

Following are examples of the WebAPI controller and the API Model class' XML
document.

```
///
    /// my product
    ///
    public class Product
    {
        ///
        /// product id
        ///
        public Guid GuidId { get; set; }
        ///
        /// product Id
        ///
        public int ProductId { get; set; }
        ///
        /// product name
        ///
        public string ProductName { get; set; }
        ///
        /// product price
        ///
        public decimal Price { get; set; }
        ///
        /// product unit
        ///
        public int Unit { get; set; }
```

```
///
    /// ProductController API
    ///
    public class ProductController : ApiController
    {
        ///
        /// products data
        ///
        public static ListProducts
        {
            get
            {
                return new List
                {
                    new Product(Guid.NewGuid(), 122, "Product A", 300, 1),
                    new Product(Guid.NewGuid(), 333, "Product B", 400, 10),
                    new Product(Guid.NewGuid(), 444, "Product C", 500, 20),
                    new Product(Guid.NewGuid(), 555, "Product D", 600, 15),
                    new Product(Guid.NewGuid(), 777, "Product E", 700, 5)
                };
            }
        }

        ///
        ///  get values for products
        ///
        ///
        public IEnumerable Get()
        {
            return Products;
        }
```

#### 3. Done! Let's browser the API Document

Now, we're done, after building the solution, you should see your XML comment
add to the Csharp class at the Swagger API documentation page.

![](https://d1p0mp3f1fx0hz.cloudfront.net/_iw664rs80.png)

### Conclusion

Swagger with ASP.NET MVC will provide very powerful API documentation and it
is very flexible.

Check the
Code
mentioned in this blog.

This walkthrough tutorial is about how to set up Swagger with ASP.NET MVC API by using Visual Studio 2015, also provides steps ofhow to customize the swagger UI.

How to Setup and Customize Swagger with ASP.NET MVC


This will make the url to always go to Home Controller's Index action.

```
routes.MapRoute(
                "AllUrl",
                "{*url}",
                new { controller = "Home", action = "Index" }
            );
```

This route will catch all the url, but if you have any other url you need to
define before this one. For example, you want to define following test url.So
when url hit /test, then will go to home/test action.

```
routes.MapRoute(
               "TestRouteName",
               "test",
               new { controller = "Home", action = "test" }
           );

  routes.MapRoute(
                "AllUrl",
                "{*url}",
                new { controller = "Home", action = "Index" }
            );
```


ASP.NET Route All Url Go to Single Action


#### Table of Contents

1. Errors
2. Compilers
3. Roslyn
4. NuGet packages
5. WebConfig
6. References

## Errors

You might have seemed something like following, your ASP.NET MVC solution
build ok but getting error following compiler error when deploying to IIS
local site or cloud web server. First, you know you have C# 6 or higher at
your application, but not sure why it causes compile error during runtime. I
have to spend some time to figure out what happens in my case, so I've
added what I found out at here so hopefully, it is able to help someone else.

```
Microsoft (R) Visual C# Compiler version 4.7.2556.0
for C# 5
Copyright (C) Microsoft Corporation. All rights reserved.

This compiler is provided as part of the Microsoft (R) .NET Framework, but only supports language versions up to C# 5, which is no longer the latest version. For compilers that support newer versions of the C# programming language, see http://go.microsoft.com/fwlink/?LinkID=533240

warning CS2008: No source files specified
error CS1541: Invalid reference option: 'C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET
        Files\root\442dd867\' -- cannot reference directories
error CS1562: Outputs without source must have the /out option specified
```

## Compilers

It is confusing but .NET development has few different .NET compile exist, the
compiler is,`csc.exe` but there's few different version. There are
followings.

  - .NET Framework's `csc.exe`

    - For example, .NET 4.6 located here.
`C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe`

Visual Studio `csc.exe`

    - Visual Studio 2013 located here.
`C:\Program Files (x86)\MSBuild\12.0\Bin\csc.exe`

    - Visual Studio 2015 located here. `C:\Program Files (x86)\MSBuild\14.0\Bin\csc.exe

Roslyn's csc.exe (example below use 1.0.0)`

    - Roslyn inside application bin folder, for example,
`/bin/roslyn/csc.exe`

So I think that's all the compiler in a different place so far and
unfortunately, the version of the CSC.EXE are different. If they're all the same version I don't think I will see
the error compiler C# 6 using C# 5 compiler.

In summary, following are the different version when I checked it out.

  - .NET Framework's csc.exe - version 4.7.2556.0

  - Visual Studio 2013 - version 12.0.21005.1

  - Visual Studio 2015 - 1.3.1.60616

  - Roslyn (1.0.0) - 1.0.0.50618

```
C:\>"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe"
Microsoft (R) Visual C# Compiler version 4.7.2556.0
for C# 5
Copyright (C) Microsoft Corporation. All rights reserved.

This compiler is provided as part of the Microsoft (R) .NET Framework, but only supports language versions up to C# 5, which is no longer the latest version. For compilers that support newer versions of the C# programming language, see http://go.microsoft.com/fwlink/?LinkID=533240

warning CS2008: No source files specified
error CS1562: Outputs without source must have the /out option specified

C:\>"C:\Program Files (x86)\MSBuild\12.0\Bin\csc.exe"
Microsoft (R) Visual C# Compiler version 12.0.21005.1
for C# 5
Copyright (C) Microsoft Corporation. All rights reserved.

warning CS2008: No source files specified
error CS1562: Outputs without source must have the /out option specified

C:\>"C:\Program Files (x86)\MSBuild\14.0\Bin\csc.exe"
Microsoft (R) Visual C# Compiler version 1.3.1.60616
Copyright (C) Microsoft Corporation. All rights reserved.

warning CS2008: No source files specified.
error CS1562: Outputs without source must have the /out option specified

C:\>"C:\projects\WebApplication1\WebApplication1\bin\roslyn\csc.exe"
Microsoft (R) Visual C# Compiler version 1.0.0.50618
Copyright (C) Microsoft Corporation. All rights reserved.

warning CS2008: No source files specified.
error CS1562: Outputs without source must have the /out option specified
```

That's why when I build the solution with Visual Studio 2015 is fine because
it is using different csc.exe, but see error sometimes when deploying to local
IIS or cloud. Also, ASP.NET MVC razor use a different compiler than C#, for
example, if you have the code as following, target framework is 4.6 and you're
not using Roslyn. This will also be built is fine, but when deploying to local
you'll see compiler error.

```
@model WebApplication1.Models.MyModel
@if (string.IsNullOrWhiteSpace(Model.Test?.ToLower()))
{

}
```

## Roslyn

Looks like things are moving to use `Roslyn` so make sure
these two NuGet packages are available at your solution.
`Microsoft.CodeDom.Providers.DotNetCompilerPlatform`,.`Microsoft.Net.Compilers. Also, make sure webconfig changes. Roslyn should be able to decide what version is good for your
solution.

It should be simple just add following Nuget Package, but just make sure
WebConfig is updated, sometimes I have the issue, WebConfig is updated on
local but IIS site's WebConfig is not updated, so end up not using Roslyn but
using .NET Framework's CSC.exe compiler.

### NuGet packages

1. Microsoft.CodeDom.Providers.DotNetCompilerPlatform

2. Microsoft.Net.Compilers

### WebConfig

```






`


```

### References

  - Command-line build with csc.exe

  - How to add dynamic compilation to your C# projects?

  - Github - roslyn

  - Removing roslyn from ASP.NET 4.5.2 project template

  - Publish website without roslyn


.NET Compiler Roslyn


#### Table of Contents

1. gulpfile.js
2. package.json

How to Use Gulp ast ASP.NET MVC 4.5.2 Template

  - Using Gulp - Microsoft

  - Setting up Gulp and Bower for an Asp.Net MVC project in Visual Studio
2013

  - How to use Gulp in Visual Studio

  - Advanced AngularJS structure with Gulp, Node and Browserify

  - Using Grunt/Gulp for Bundling and Minification in ASP.NET

  - Migrating From ASP.NET MVC 5 to MVC 6

  - Introducing Gulp, Grunt, Bower, and npm support for Visual Studio

  - ASP.NET 5: Managing Client-side Dependencies with NPM, Bower and Gulp

### gulpfile.js

```
var gulp = require('gulp');
var connect = require('gulp-connect');
// requires browserify and vinyl-source-stream
var browserify = require('browserify');
var source = require('vinyl-source-stream');
var concat = require('gulp-concat');
//var cssmin = require("gulp-cssmin");
var uglify = require("gulp-uglify");

gulp.task('connect', function () {
    connect.server({
        root: 'public',
        port: 4000
    })
});

gulp.task('browserify.1', function () {
    // Grabs the app.js file
    return browserify('./app/test1/app.js')
        // bundles it and creates a file called main.js
        .bundle()
        .pipe(source('main.js'))
        // saves it the public/js/ directory
        .pipe(gulp.dest('./public/js/'));
});

gulp.task('browserify.2', function () {
    // Single point of entry (make sure not to src ALL your files, browserify will figure it out for you)
    //gulp.src(['./app/test2/app.js'])
    //.pipe(browserify({
    //    insertGlobals: true,
    //    debug: true
    //}))
    //// Bundle to a single file
    //.pipe(concat('bundle.js'))
    //// Output it to our dist folder
    //.pipe(gulp.dest('./public/js/'));

    // Grabs the app.js file
    return browserify('./app/test2/app.js')
        // bundles it and creates a file called main.js
        .bundle()
        .pipe(source('main.2.js'))
        // Bundle to a single file
        //.pipe(concat('bundle.js'))
        // saves it the public/js/ directory
        .pipe(gulp.dest('./public/js/'));
});

gulp.task('browserify.3', function () {
    // Grabs the app.js file
    return browserify('./app/test3/app.js')
        // bundles it and creates a file called main.js
        .bundle()
        .pipe(source('main.3.js'))
        // saves it the public/js/ directory
        .pipe(gulp.dest('./public/js/'));
});

gulp.task("min:js", function () {
    gulp.src(["./public/js/main.2.js"], { base: "." })
        .pipe(concat("./public/js/dist/main.2.js"))
        .pipe(uglify())
        .pipe(gulp.dest("."));

    gulp.src(["./public/js/main.js"], { base: "." })
    .pipe(concat("./public/js/dist/main.js"))
    .pipe(uglify())
    .pipe(gulp.dest("."));

    gulp.src(["./public/js/main.3.js"], { base: "." })
     .pipe(concat("./public/js/dist/main.3.js"))
     .pipe(uglify())
     .pipe(gulp.dest("."));
});

gulp.task("min", ["min:js"]);

// Views task
gulp.task('views', function () {
    //// Get our index.html
    //gulp.src('./app/test2/index.html')
    //// And put it in the dist folder
    //.pipe(gulp.dest('dist/'));

    // Any other view files from app/views
    gulp.src('./app/test2/views/**/*')
    // Will be put in the dist/views folder
    .pipe(gulp.dest('./public/app/test2/views/'));
});

gulp.task('watch', function () {
    gulp.watch('app/**/*.js', ['browserify.2', 'browserify.1', 'views'])
});

gulp.task('default', ['connect', 'watch']);
```

### package.json

```
{
  "name": "test_angular",
  "version": "1.0.0",
  "description": "test",
  "main": "index.js",
  "dependencies": {
    "angular": "^1.5.5",
    "gulp": "^3.9.1"
  },
  "devDependencies": {
    "angular": "^1.5.5",
    "angular-route": "^1.5.5",
    "browserify": "^13.0.0",
    "gulp-concat": "^2.6.0",
    "gulp-connect": "^3.2.2",
    "gulp-cssmin": "^0.1.7",
    "gulp-uglify": "^1.5.3",
    "vinyl-source-stream": "^1.1.0"
  },
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "repository": {
    "type": "git",
    "url": "no git"
  },
  "keywords": [
    "no",
    "keywords"
  ],
  "author": "",
  "license": "ISC"
}
```

Other Resources

  - Introduction to Bower, Grunt, and Gulp in Visual Studio

  - How to use Gulp in Visual Studio

  - ASP.NET - Progressive Enhancement with ASP.NET and React


How to Use Gulp ast ASP.NET MVC 4.5.2 Template.

Gulp ASP.NET MVC 4.5.2 Template and Browserify


#### Table of Contents

1. Learn .NET!?
2. Rss
3. Forums
4. Other

## Learn .NET!?

Following are few resources you can learn .NET.

### Rss

1. [http://www.asp.net

https://blogs.msdn.microsoft.com

http://sxp.microsoft.com

https://channel9.msdn.com

### Forums

http://forums.dotnetfoundation.org

### Other

channel9.msdn.com

gitter.im](http://www.asp.net/rss/content)

2. dotnet.github.io

3. blogs.msdn.microsoft.com/


List of Resources to Learn .NET


## About IIS Rewrite Module

First if you want to use it, you have to
download and install to your web server. It is support IIS7, IIS7.5, IIS 8, IIS 8.5,
IIS 10. List of features include, Rules-based Url rewriting engine, Wildcard
pattern matching,and to check more see
here.

At this blog, I'll show a case as you want to direct as following scenario.

If use type following url

  - http://www.example.com

  - http://example.com

  - https://www.example.com

  - https://example.com

Will go to `https://example.com`

Anyway, following is the code you need to add to `web.config.`

```















```


How to use IIS Rewrite module for redirect from http to https.

Use IIS Url Rewrite Module to Redirect from Http to Https


```





```

Above is simple syntax for setup windows authentication at web.config.

At your IIS site, you also need to change things, you'll need to go to your
IIS site and select Authentication, you should been see Windows
Authentication. If there's no Windows Authentication then you need to install.
You need to also turn Anonymous Anthentication off.

That's should be all of it, but you might seen something that when you hit the
site it'll keep asking the user and password. Although you enter the correct
user and password, it'll ask again.

So, I searched at stackoverflow, following answer resolve my issue.

401 Unauthorized error web api mvc windows authentication

1. *Set the DisableStrictNameChecking registry entry to 1. For more
information about how to do this, click the following article number to
view the article in the Microsoft Knowledge Base: 281308 Connecting to SMB
share on a Windows 2000-based computer or a Windows Server 2003-based
computer may not work with an alias name

Click Start, click Run, type regedit, and then click OK.*

2. *In Registry Editor, locate and then click the following registry key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0

Right-click MSV1_0, point to New, and then click Multi-String Value.

Type BackConnectionHostNames, and then press ENTER.*

3. *Right-click BackConnectionHostNames, and then click Modify.*

4. *In the Value data box, type the host name or the host names for the sites
that are on the local computer, and then click OK.

Quit Registry Editor, and then restart the IISAdmin service.*


Windows Authentication


Fix 404 error when request bootstrap fonts.

If you getting 404 on follwoing files at ASP.NET, which are font files for
bootstrap.
You can try following way to resolve this issue.

  - glyphicons-halflings-regular.eot

  - glyphicons-halflings-regular.svg

  - glyphicons-halflings-regular.ttf

  - glyphicons-halflings-regular.woff

  - glyphicons-halflings-regular.woff2

```

adding static content mime type to web.config.











```


Fix 404 error when request bootstrap fonts.

Fix 404 Issues to Load Bootstrap Icons on IIS


#### Table of Contents

1. About Ninject
2. Get Ninject Library
3. Interface
4. Class
5. Dependency Resolve class in Ninject
6. Set up Ninject Dependency in application Global Class
7. Setup Ninject Dependency in Ninject Module
8. Use Ninject Dependency in ASP.NET MVC Controller
9. Unit test in Ninject + ASP.NET MVC App
10. Mocking data in Unit Test - Ninject + Moq
11. In conlusion
12. What's my other choice for Dependency in .NET?

## About Ninject

[Nuget Ninject

Ninject.org](https://www.nuget.org/packages/Ninject/)

[Blog - About Ninject in C#

Code Project - Ninject Example

### Get Ninject Library

Last update is Sunday, January 4, 2015, looks like no one update/maintain it
anymore...

```
Install-Package Ninject -Version 3.2.2
```

### Interface

In C# for using Dependency Injection, you'll define your interface and class
which will implement this interface. Once you defined interface and bind the
relation via Ninject, then you could use this interface at other layer or same
layer and without knowing what's the detail implementation about the specific
interface.

```
namespace NinjectConstructorInjectionWeb
{
    public interface ISamurai
    {
        string GetData();
    }
}
```

### Class

```
namespace NinjectConstructorInjectionWeb
{
    public class Samurai : ISamurai
    {
        public string GetData()
        {
            return "my data";
        }
    }
}
```

### Dependency Resolve class in Ninject

```
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web.Mvc;
using Ninject.Syntax;
using Ninject;

namespace NinjectConstructorInjectionWeb
{
    public class NinjectDependencyResolver : IDependencyResolver
    {
        private readonly IResolutionRoot _resolutionRoot;

        public NinjectDependencyResolver(IResolutionRoot kernel)
        {
            _resolutionRoot = kernel;
        }

        public object GetService(Type serviceType)
        {
            return _resolutionRoot.TryGet(serviceType);
        }

        public IEnumerable GetServices(Type serviceType)
        {
            return _resolutionRoot.GetAll(serviceType);
        }
    }
}

```

### Set up Ninject Dependency in application Global Class

By using Ninject, you could either setup binding as following, or setup
binding as each module by inherict from `NinjectModule` class.

```
protected void Application_Start()
        {
            AreaRegistration.RegisterAllAreas();
            RegisterGlobalFilters(GlobalFilters.Filters);
            RegisterRoutes(RouteTable.Routes);


            // setting for Ninject
            IKernel kernel = new StandardKernel();

            kernel.Bind().To();

            DependencyResolver.SetResolver(new NinjectDependencyResolver(kernel));
        }
```

### Setup Ninject Dependency in Ninject Module

```
public  class  MyModule  : NinjectModule
     {
         public  override  void  Load()
         {
             Bind().To()
                 .WithConstructorArgument("kernel" , this .Kernel);
         }
     }
```

### Use Ninject Dependency in ASP.NET MVC Controller

The beauty of doing Depenency Injection in ASP.NET MVC controller is by
passing the interface to the contructor of the MVC controller. User/Client
don't need to know about the interface's logic.

```
private readonly ISamurai _samurai;
public HomeController(ISamurai samurai)
{
    _samurai = samurai;
}

public ActionResult Test()
{
    // you should see "my data" here.
    ViewBag.Hi = _samurai.Attach();
    return View();
}
```

### Unit test in Ninject + ASP.NET MVC App

Another important thing with Dependency Inject in Ninject is, UnitTest.
Because everything is interface, you could setup different data at UnitTest to
test your actual logic.

```
[TestMethod ]
         public  void  Product()
         {
 			  ISamurai  testService = new  Samurai();

 			  HomeController  controller = new  HomeController (testService);

            controller.Product();
         }
```

### Mocking data in Unit Test - Ninject + Moq

Use Ninject + Moq + Unit Test, so you can mock the temp data to the interface
and pass to your controller.

```
public  static  IProductBzService  GetProductService()
         {
             Mock  mock = new  Mock ();
             mock.SetupGet(x => x.Id).Returns(1);
             mock.SetupGet(x => x.Name).Returns("test name" );
             mock.SetupGet(x => x.Price).Returns(11.11m);
             mock.SetupGet(x => x.Unit).Returns(2);
             mock.Setup(x => x.Total()).Returns(999.999m);

             return  mock.Object;
         }
```

### In conlusion

Ninject is cool C# .NET library for dependency injection, about couple years
ago. looks like no one update it anymore, I would think this will be a legacy
Denepencey Injection Library in the future.

### What's my other choice for Dependency in .NET?

I would recommand use
Autofac](http://blog.agilistic.nl/a-step-by-step-guide-to-using-ninject-for-dependancy-injection-in-c-sharp/),
it is well document, support different .NET library, such as ASP.NET Web
Forms, MVC, WebAPI 1, WebAPI 2, Signal R, RIA, OWIN, WCF, MEF, NHibernate,
Moq.

1. Autofac

2. Castle Windsor

3. StructureMap

4. Spring.NET

5. Unity

6. Puzzle.NFactory

7. Ninject

8. S2Container.NET

9. PicoContainer.NET

10. LinFu


How to use Dependency Injection in Ninject at ASP.NET MVC application

Category ASP.NETMVC